home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / purity25.zip / PURITY.DOC < prev    next >
Text File  |  1993-05-01  |  11KB  |  274 lines
  1.  
  2.  
  3.  
  4.  
  5.                                PURITY 500
  6.  
  7.                                  v2.5
  8.  
  9.                               May 1, 1993
  10.  
  11.                         PCBoard 14.x and GAP 4.x
  12.                            WILDCAT!, Spitfire
  13.                              QBBS, RBBS, RA
  14.                               WWIV,TriBBS
  15.  
  16.                                    by
  17.  
  18.                              Dennis Maidon
  19.                           PAROLE TECHNOLOGIES
  20.                           311 Buffalo Rd
  21.                           Clayton, NC  27520
  22.                          (919) 965-3600 -> Voice
  23.                          (919) 965-9885 -> FAX
  24.  
  25.                           The Parole Board BBS
  26.  
  27.               (919) 965-4696 -> US Robotics Dual Standard
  28.  
  29.  
  30.  
  31.                                 OVERVIEW
  32.                                 ________
  33.  
  34.  
  35.  
  36.         This ZIP file was created using the -AV function of PKZIP.  If
  37.         my AV is missing then this file may not be complete of has been
  38.         tampered with.  Complete and current editions of this program
  39.         are always available for D/L on The Parole Board BBS.  If the AV
  40.         is missing please complain to your sysop to stop the practice of
  41.         removing AV's as this is your assurance from the programmer that
  42.         the file is complete and virus free.
  43.  
  44.  
  45.                               INSTALLATION
  46.                               ____________
  47.  
  48.    Installation is fairly easy and straight-forward. The following steps and
  49.    examples should have you up and running in a very short period of time.
  50.    It is assumed that you are familiar with setting up DOORS on your system.
  51.    To this end, only examples of the configuration file and Door batch file
  52.    are described.
  53.  
  54.       1) Create a directory to hold all PURITY 500 files
  55.  
  56.       2) Unzip PURITYxx.ZIP into the the above directory
  57.  
  58.       3) Run 'INSTALL.BAT' This will unzip all the files and create the
  59.          necessary subdirs.
  60.  
  61.       4) Create a configuration file, with a name of your choice, or
  62.          modify the  PURITY.CFG file that is enclosed.
  63.          A description follows:
  64.  
  65.    C:\WILDCAT\CALLINFO.BBS ──┐  <- For Wildcat! 2.x
  66.    C:\WC30\USERINFO.DAT      │  <- For Wildcat! 3.0 (Must point to NODEx dir)
  67.    C:\PCB\PCBOARD.SYS        │  <- For PCBoard using PCBOARD.SYS only
  68.    C:\PCB\USERS              │  <- For PCBoard using USERS only
  69.    C:\BBS\GTUSER.BBS         │  <- For GT Power systems
  70.    C:\BBS\DOOR.SYS           │  <- For Systems that support DOOR.SYS
  71.    C:\BBS\DORINFOx.DEF       │  <- For QBBS/RBB/RA.  Replace x with Node #.
  72.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  73.    C:\BBS\TRIBBS.SYS         │  <- For TriBBS
  74.    C:\BBS\CHAIN.TXT       ───┘  <- For WWIV
  75.    The Parole Board BBS         <- Your BBS Name
  76.    Dennis                       <- SysOp's First Name
  77.    Maidon                       <- SysOp's Last Name
  78.    00000                        <- Registration Number
  79.    YES                          <- Create Log
  80.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  81.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  82.    15                           <- Minimum questions before scoring
  83.    100                          <- Minimum security level allowed in door.
  84.    WC                           <- "WC" = WC!3.x "PCB" = PCBoard "N" = ANSI/ASCii
  85.    RIP                          <- "RIP" create RIP bulls "N" do not create
  86.  
  87.      Edit this .CFG file to suit your individual BBS.  All 12 lines MUST
  88.      be present.
  89.  
  90.    Line 1:  This line points to where PURITY.EXE will find the callers
  91.             information file.  Just include the line that your particular
  92.             BBS uses.  DO NOT put all of them in the CFG file.
  93.  
  94.    Line 2:  Place the name of your BBS on this line.
  95.  
  96.    Line 3:  SysOp's first name goes here.
  97.  
  98.    Line 4:  SysOp's last name goes here.
  99.  
  100.    Line 5:  Your Registration Number goes here if registered
  101.  
  102.    Line 6:  YES to create .LOG log or leave blank
  103.  
  104.    Line 7:  Enter the complete path and name of the ANSI bulletin that
  105.             you want  PURITY 500 to create.
  106.  
  107.    Line 8:  Enter the complete path and name of the ASCii bulletin that
  108.             you want  PURITY 500 to create.  If You specify "WC" or
  109.             "PCB" on line #11, you may leave this line blank.
  110.  
  111.    Line 9:  Minimum # of questions to answer before user is scored
  112.  
  113.    Line 10: The minimum security level that is allowed in the door.
  114.  
  115.    Line 11: Type of bulletins you wish to create.  "WC" = Wildcat!3.x
  116.             color codes. "PCB" = PCBoard color codes "N" = ANSI/ASCii
  117.             bulletins
  118.  
  119.    Line 12: If you wish to create a RIP style bulletin, place "RIP" on
  120.             this line.  Place "N" if you do not want RIP bulletins.
  121.  
  122. NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
  123.       this file does not provide the ComPort% and NodeNum% variables, advise
  124.       your Door users to add them to this .CFG file on lines 5 and 6
  125.       respectively. Both variables will default to 1.
  126.  
  127.         If you use the above CFG file be sure to remove all remarks and use
  128.    a pure ASCII editor such as EDLIN or QEDIT.  Hidden control codes could
  129.    cause the program to depart for worlds unknown.
  130.  
  131.       4) Create a batch file or modify the PURITY file supplied. A
  132.          description of this file follows:
  133.  
  134.             ECHO OFF
  135.             CD \DOORS\PURITY        Location of  PURITY 500 files
  136.             PURITY PURITY.CFG       EXE filename and CFG filename
  137.             CD\WCAT
  138.             CAT.BAT
  139.  
  140.        5) When running in more than one node, be sure to supply a
  141.           different configuration name for each node (your choice of name).
  142.  
  143.           EX: PURITY1.CFG  PURITY2.CFG
  144.  
  145.            PURITY 500 has been tested under LIVECAT! and performs very well.
  146.  
  147. NOTE: DoorFrame supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  148.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  149.       number after the configuration filename. Let's assume your Door is
  150.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  151.       passed to your Door would be:
  152.  
  153.         FOOBAR FOOBAR.CFG /5
  154.         FOOBAR FOOBAR.CFG *5
  155.  
  156.       The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 that
  157.       is normally used with COM1. No /x parameter is needed for the standard
  158.       IRQ's.
  159.  
  160.  
  161. Fossil Driver Support
  162. ---------------------
  163. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  164. Fossil driver instead of the standard COM ports, just put /FD on the command
  165. line when running the door. For example:
  166.  
  167.      MYDOOR MYDOOR.CFG /FD
  168.      MYDOOR MYDOOR.CFG *FD
  169.  
  170. indicates that a Fossil driver is present and should be used. If no Fossil
  171. driver is detected, DoorFrame will print a message to that effect and exit
  172. the door gracefully.
  173.  
  174. NOTE:  You may now use one (1) CFG file for multi-node by using the
  175. environment variables.
  176.  
  177. When specifying the location of the system file on line 1 of the doors .CFG
  178. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  179. and %wcnodeid%. Some examples:
  180.  PCBoard: 
  181.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  182.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  183.  
  184.  Wildcat!:
  185.    USERINFO.DAT in C:\WC30\WCWORK\NODE1   - C:\WC30\WCWORK\NODE%WCNODEID%
  186.  
  187. Non-PCBoard systems may use the PCB environment variables by setting them
  188. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  189.  SET PCBDRIVE=C:
  190.  SET PCBDIR=\BBSDIR
  191.  SET PCBNODE=1
  192.                              --------------
  193. Create the CFG file(s) for you particular BBS.  You will also need a DOORx.BAT
  194. to run the door.  This one is simple.
  195.  
  196. @ECHO OFF
  197. CD \DOOR\PURITY
  198. PURITY PURE.CFG /5
  199.               ──┬─
  200.  ┌──────────────┘
  201.  └ If you are running non-Standard Com ports on your BBS, you will need to pass
  202.  the proper IRQ to the door.  It doesn't hurt to pass the IRQ even if they are
  203.  standard.  If a user enters the door and it just sits there acting sort of
  204.  stupid, it's probably looking for the correct IRQ.  Always pass it on the
  205.  command line and there will be no question.  Some networks have a problem
  206.  using the "/" symbol.  P500 will now accept an asterisk "*" in place of
  207.  the "/".  You may also use the environment variable in the DOORx.BAT file to
  208.  pass info to the door.
  209.  
  210. PURITY PURE%WCNODEID%.CFG /%WCIRQID%
  211.  
  212. Make sure you DO have the variables set if you use this method.
  213.  
  214.                            -----------------
  215.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC files
  216. if they are included in the package.  They sometimes contain some very
  217. useful information. <G>  Of course you can do like me, just set the darn
  218. thing up without the docs then fuss at the door author for not making it
  219. simple enough to work the first time.
  220.  
  221.       When a user first log onto ' PURITY 500' the program checks his
  222. security level to make sure that he has a high enough level to enter the
  223. door.  it will then check the <user>.USR files to see if he has been
  224. locked out of the door by the sysop.  If the user passes both of these
  225. tests then he may proceed in playing P500. This info will be used each
  226. time the user logs on to pick up his ALIAS and other info.
  227.  
  228.                               LEGALITIES
  229.                               __________
  230.  
  231.  
  232.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  233.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  234.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  235.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  236.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  237.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  238.       OR BREACH OF ANY WARRANTY.
  239.  
  240.                              DISTRIBUTION
  241.                              ____________
  242.  
  243.    You may make this file available for downloading from your BBS or you may
  244.    upload it to any BBS of your choice, provided that you do not make any
  245.    changes to the contents of the archive (ZIP file). The archive and its
  246.    individual contents may not be used by any service that charges any money
  247.    whatsoever, without the written permission of the author.
  248.  
  249.  
  250.                              REGISTRATION
  251.                              ____________
  252.  
  253.    I am not a subscriber to the "Crippleware" concept, and this program
  254.    reflects that philosophy. This is a full-featured program, whose
  255.    functionality is not hampered in any way, whether you register it or
  256.    not.  It is only $15 to register this door.  There is a delay that
  257.    will be removed upon registration.
  258.  
  259.                                  THANKS
  260.                              --------------
  261.  
  262.     Special thanks goes out for my wife who is definitely a
  263.     "Computer Widow".
  264.  
  265.     Ted Freeman the author of DOORFRAME, a first class BBS Doors
  266.     Development Library.
  267.  
  268.     My BBS users who have had to endure constant badgering to help me
  269.     test the programs that I have written.
  270.  
  271.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the
  272.     greatest BBS Software on the market, WILDCAT! 3.0.
  273.  
  274.